home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / DiceSource / doc / fdtolib.doc < prev    next >
Text File  |  1994-02-13  |  3KB  |  85 lines
  1.  
  2. dcc/fdtolib                            dcc/fdtolib
  3.  
  4.                 FDTOLIB.DOC
  5.  
  6.                   Matthew Dillon
  7.                   891 Regal Rd.
  8.                   Berkeley, Ca. 94708
  9.                   USA
  10.  
  11.                   dillon@overload.Berkeley.CA.US        --or--
  12.                   uunet.uu.net!overload!dillon
  13.  
  14. SYNOPSIS
  15.     FDTOLIB files/wildcard.fd [-h hdrfile] -o libname [-mr] [-mD] <more_opts)
  16.  
  17.     files/wildcard.fd    specifies one or more files and/or AmigaDOS
  18.             wildcarding that represents the .FD files that
  19.             are to be processed into a library
  20.  
  21.     -h hdrfile        hdrfile is a .H files that #include's all
  22.             prototypes associated with the FD files.  It
  23.             is only used if the -mr option is specified
  24.  
  25.     -o libname        specify output library name
  26.  
  27.     -mr         specify that a REGISTERED call interface library
  28.             is to be generated (for DICE -m[r,R,RR] options),
  29.             else generates a normal stack-args interface
  30.             library.
  31.  
  32.     -mD         specify large-data model, else small-data model
  33.  
  34.     -I include-dir    passed to DCC
  35.  
  36.     -p prefix        Set prefix (currently only for standard generation,
  37.             doesn't work with -mr).  The default is a single
  38.             unscore.  This option is normally used to generate
  39.             _hyper_ tags for dynamic.library
  40.  
  41.     -prof        Generate profiling code for the tags.  This will
  42.             cause all library calls to be profiled when the
  43.             program that links with this library is run.
  44.  
  45.     -auto library    Generate auto-init code for library after the
  46.             tags.  <library> in this case is the name of
  47.             the shared library.  For example, -auto fubar.library
  48.  
  49.     -AUTO library    Generate ONLY auto-init code for library (do
  50.             not generate tags)
  51.  
  52. DESCRIPTION
  53.  
  54.     FDTOLIB will create an amiga standard library out of specified .FD
  55.     files (for example, you can generate most of amiga.lib by using
  56.     the .FD files on your 1.3 Extras disk).
  57.  
  58.     Basically, FDTOLIB will generate one of four types of libraries:
  59.  
  60.     default     small-data model
  61.     -mD        large-data model
  62.     -mr        small-data model + DICE registered parameters entry pts
  63.     -mr -mD     large-data model + DICE registered parameters entry pts
  64.  
  65.     If -mr is used suitable prototypes must be specified with the -h option.
  66.     In this case, FDTOLIB will run DCC with a special option to have it
  67.     generate a register-specification file for it to match up again the
  68.     FD files.
  69.  
  70.     FDTOLIB then proceeds to scan the .FD files, creating temporary
  71.     assembly files in T: and assembling them with DAS, then appending
  72.     them to the output library and deleting the scratch files.    This
  73.     step occurs for each function in each .FD files.
  74.  
  75.     (For faster operation, you will want to make DAS resident for the
  76.     duration)
  77.  
  78.     If -mr was specified, FDTOLIB only generates library entries for
  79.     those routines for which a prototype exists.  At the end of the
  80.     run FDTOLIB will report any routines which existed in the .FD files
  81.     but did not have a prototype.
  82.  
  83.  
  84.  
  85.